home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / moni151c.zip / MONI151C.ZIP / SYSOP.DOC < prev    next >
Text File  |  1987-05-17  |  18KB  |  448 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                     MONITOR PROGRAM FOR DOORS
  11.  
  12.                              for the
  13.  
  14.                       IBM Personal Computer
  15.  
  16.                           Version 15.XX
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                by
  24.  
  25.                        Bob Westcott
  26.                        7 Dunloggin Drive
  27.                        Merrimack N.H. 03054
  28.                        Voice (603) 424-6977
  29.                        Data  (603) 424-5497
  30.  
  31.                           April 1, 1987
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.      DO NOT USE DOORWARE PROGRAMS THAT ARE AT A LOWER LEVER THAN
  69.  
  70.                               15.1A
  71.  
  72.  
  73. New features on version 15.1A:
  74.  
  75. You can now see and send color/music.
  76. You can control if sound can be heard (on or off).
  77. You can truly run muilt nodes without interference between nodes.
  78. All   problems  received  reference  14.xx  problems  have   been 
  79. corrected.
  80.  
  81. This file ONLY tells you how to set up for MONITOR not how to set 
  82. up your files to operate the doors system.   The doc.  for how to 
  83. setup your files for doors is in the file called BATCH.ARC and if 
  84. you do not have this file you may get it at my RBBS.
  85.  
  86. First thing I must do is to thank Tom Mack and Jon Martin for the 
  87. time,   energy  (and  love)  for  the best BBS  in  the  country.  
  88. Without  there  effort  none of us would be able to  run  such  a 
  89. wonderful piece of software such as the RBBS-PC.
  90.  
  91. 1.1 Introduction
  92. ----------------
  93. The  Monitor program is a program that will allow you to  set  up 
  94. your  RBBS with more doors using less batch files (less confusion 
  95. and  less space used on your disk).  This program will also  tell 
  96. your  door  users what there total score for all  games  on  your 
  97. system.  It  will also list the 10 top players for the month  for 
  98. all  the  games on your system.  This program will work  for  all 
  99. DOORWARE  software  except for CHESSDOR,  which is not a  program 
  100. that gives scores.
  101.  
  102. Because  it  is very possible to cause a security problem on  the 
  103. RBBS (people being able to get into your DOS) the source will not 
  104. be made available.   I will help anyone who is interested in  the 
  105. way you write software to work on the 'Doors' that calls. 
  106.  
  107. The software is able to handle multi-tasking under Multi-Link and 
  108. Double Dos, but is limited to 9 nodes.
  109.  
  110. 1.2 Update Conventions
  111. ----------------------
  112. Since  this software is very closely tied to the RBBS software  I 
  113. will update it when new version/levels of the RBBS are  released.  
  114. The  version  level  of MONITOR will be the same as  the  version 
  115. level that it will work with of the RBBS.  When versions of  RBBS 
  116. are  released  that  do  not require a  change  to  the  Doorware 
  117. programs there may or may not be a new version of Doorware.
  118. The latest version of Doorware will always be on my RBBS.
  119.  
  120. 2.1 Required files
  121. ------------------
  122. You  must have a batch file that you are running your RBBS  from. 
  123.  
  124. The purpose of the files are as follows:
  125.  1. MONITOR.EXE      The operational software.
  126.  2. MONITOR1.EXE     Operational software.
  127.  3. MONITOR.SCR      This  is  the  daily score  board, but it is                   
  128.                      also    the    file    that    holds    your  
  129.                      system requirements.
  130.  4. MONITOR1.SCR     This is the monthly score board.
  131.  5. GAMES.BAT        The batch  file  that gets  you  to  MONITOR                      
  132.                      from the doors
  133.  5. SYSOP.DOC        This file.
  134.  6. PRELOG.MON       The  same  as  on the RBBS it allows you  to 
  135.                      place notices on the system (optional).
  136.  7. GAME.DOR         Name of the games available.
  137.  8. TRIVIA.DOR       Allows Trivia questions (optional).
  138.  9. NAMES.DOR        Holds  the information about users  (created 
  139.                      automatically) 
  140. 10. TIMLIMIT.DOR     Sets  the  amount  of session time  for  the 
  141.                      different times of day (optional).
  142. 11. MONITORG.DOR     A  graphic/music  file that will be outputed 
  143.                      each time the monitor is called (optional).
  144.  
  145. 2.0 Setup
  146. ---------
  147. Because this software reads information from the RBBS files it is 
  148. very important that the supplied files MUST be placed on the same 
  149. drive  that the RBBS-PC.DEF,  RBBS1PC.DEF,  RBBS2PC.DEF etc.  are 
  150. located.
  151.  
  152. The port that is use, the number of data bits, RBBS name, and the 
  153. baud  rate is taken from the RBBS files and used in  the  MONITOR 
  154. program without any need for you to insert them in a file.
  155.  
  156. You  must make the changes you want on following  information  in 
  157. the 1st 8 fields of the MONITOR.SCR file:
  158.  
  159. 1. Field  #1  The  number  of  minutes a player must  wait  after 
  160. signing off before he/she may use the monitor again.  (This  does 
  161. NOT apply to SYSOP he may sign on as often as he/she wishes)
  162. 2. Field #2 The foregound color.
  163. 3. Field #3 The background color.
  164. 4. Field #4 The border color.
  165. 5. Field #5 The  number  of  minutes  a player is allowed without                   
  166.    making a move.
  167. 6. Field #6 The total number of minutes allowed on MONITOR.
  168. 7. Field #7  This  field  will allow you to backup any  file  you 
  169.    wish!! (see 7*) for info on this field.
  170. 8. Field #8 This field determins if SYSOP score will be used.
  171.    If  set to '0' then the SYSOP's score will NOT be  posted  and        
  172.    if  set to a '1' then his score WILL be posted like any  other          
  173.    user.
  174.  
  175.  
  176.  
  177. 7* The following example will show how this field works:
  178.  
  179. D C:BBSLIST.DOR C:\BKUP\BBS.DOR
  180.  
  181. The 1st segment of the field must be a D or W or M
  182. D=Backup daily
  183. W=Backup weekly (on Saturday)
  184. M=Backup monthly
  185.  
  186. The 2nd segment of the field is the file you wish to backup,  you 
  187. may use any available drive and/or sub-directory.
  188.  
  189. The  last segment of the field is the file to which the backup is 
  190. going and the MAX # of charactors is three(3) before the  extent. 
  191. You may also use any available drive and/or sub-directory.
  192. Using the above example file the bakup file name will be:
  193.    BBS06256.DOR
  194. As you can see 5 numbers were added to the file name and they are 
  195. the 2 digits of the month,  the 2 digits of the day, and the last 
  196. digit  of the year that the file was backed up.  That is why  you 
  197. may only use 3 charactors in the file name!
  198.  
  199. You may do as many as 15 different backups using any combinations 
  200. of D, W, or M that you like as long as the input line is not over 
  201. 254 chars. The following is legal:
  202.  
  203. D C:BBSLIST C:\BKUP\BBS.DOR W JUNK.EXE JUN.BAK M HERE A:HER 
  204.  
  205. LIMITATIONS:
  206. The file will only be backed up if the monitor is run. If you are 
  207. using a daily backup it will not backup on any day the monitor is 
  208. not  run.  If  you are doing a weekly backup it is done  only  on 
  209. Saturday's  and will not do a backup if the monitor is not run on 
  210. Saturday.  If  you are doing a monthly backup it WILL backup  the 
  211. first day of each month that the Monitor is run that month.
  212.  
  213.  
  214.  
  215. When using the monitor the numbers of amount of time available to 
  216. play  the  game will be the time it states in the  monitor.  This 
  217. means  that  the  time  placed in the games is  NOT  used  for  a 
  218. timelimit.  The number of times is still set to work in the games 
  219. area.  This  give  you  the option (by setting it  high)  to  let 
  220. players  become very good at one game or (by setting it  low)  to 
  221. make  the users learn may games.  I have found it is best to  set 
  222. all  the games to a high level as different strokes for different 
  223. folks is very true.
  224.  
  225. The  MONITOR.SCR file will create itself if it can not find  one. 
  226. It will set the all starting scores to 0. If you wish to start at 
  227. any other score you can use EDLIN to change them, but remember to 
  228. change them EACH month as they will be reset to 0 with the  first 
  229. user each month.
  230.  
  231.  
  232. The  MONITOR1.SCR  file is very simple and will create itself  if 
  233. one can not be found.
  234. This  files holds the monthly champ information,  but will NOT be 
  235. outputed until the first monthly champ is created.
  236.  
  237. If  you are using this monitor program the game programs that you 
  238. use with it will lose some of there features as follows:
  239.  1.  Field  #1 (# of times per day you may play) will be disabled 
  240.      in  the  game program and will have the time  limit  of  the 
  241.      monitor program only NO # of times will be used.
  242.  2.  Field  #6  (total minutes allowed) will be disabled and  the 
  243.      game software will use the limit set by the monitor program.
  244.  
  245. You  may have Trivia questions on the monitor program which  will 
  246. give  your  users a chance to answer Trivia questions  for  extra 
  247. points (from 1 to 1000 points random).
  248. To set Trivia up you must make a file called TRIVIA.DOR with  the 
  249. entries  as  follows  1st  line question,  2nd  line  answer  (IN 
  250. CAPITALS) with up to 20 questions (40 line entries).  See example 
  251. file that comes with this software.
  252. If  you don't want Trivia questions then insure there is no  file 
  253. called TRIVIA.DOR on your disk.
  254.  
  255. You  may  set the timelimits of each session to be different  for 
  256. different times of the day. The entries are as follows the 1st is 
  257. the  start  time the second is the end time and the  3rd  is  the 
  258. amount of time. BUT you CAN NOT go past midnight with one entry
  259. Look at the following example and the sample file enclosed.
  260.  
  261. 22:00:00 
  262. 02:00:00   This will NOT work (it must be made into 2 entries). 
  263. 45      
  264.  
  265. 22:00:00
  266. 23:59:59
  267. 45
  268. 00:00:00   This will work.
  269. 02:00:00
  270. 45
  271.  
  272. After  you  enter  all  your time limits you  may  also  mke  the 
  273. following entries which will also make other time limits.
  274.  
  275. W xx  Where the xx is a timelimit in minutes
  276.  This will limit time on weekends to the xx value for 24 hours
  277. H xx-yy zz Where xx=month yy=day and zz=timelimit in minutes
  278.  This will state it is a holiday and timelimit=zz for 24 hours
  279. M Xxx yy Where Xxx=month ie Jun, Sep (1st 3 letters of month
  280.          the 1st letter MUST be capital) yy=timelimit in minutes
  281.  This will state summer vacation and the entire month will have
  282.  a yy timelimit.
  283. S xx-yy zz ww.... Where xx=month yy=day zz=timelimit in minutes
  284.                   WW... Any statement you would like.
  285.  This will set timelimit for for 24 hours on the date you state
  286.  and place WW... as the reason (see the TIMLIMIT.DOR file)
  287. You may have a max. of 20 line entries
  288.  
  289.  
  290. To list the games you are using with the monitor program you must 
  291. make a file called GAMES.DOR with a line entry for each game that 
  292. is being used.  This must be the game file name letter for letter 
  293. except  for the extension ie game name TIMEDOR.EXE your  GAME.DOR 
  294. file must have Timedor not Time. See example with software.
  295.  
  296. Example GAME.DOR
  297.  
  298. Sword-----> Try to kill Medusa in the green kingdom
  299.  
  300. The  '-' is the start of the program description it must be there 
  301. or the program will not be called correctly!!
  302.  
  303. I  have also supplied a program that is called DORSYSOP.BAS  this 
  304. program  will  allow you to do about anything use wish  with  the 
  305. file called NAMES.DOR.  This file is created automatically by the 
  306. software  and  holds the Names,  Score,  Last date  on,  and  the 
  307. amount of time used that date (in seconds).  The program dorsysop 
  308. allows  you to change the data in that file including removing  a 
  309. user.  Remember you are on your own if you mess with this file. I 
  310. am also supplying this software in source so you may change it in 
  311. any way you wish, BUT AS STATED YOU ARE ON YOUR OWN!!!
  312.  
  313. ***** N O T E *****
  314. To  use the doorware programs with this monitor all programs used 
  315. must be at least version 15.1A or they will not work correctly.
  316.  
  317. If  you  were running these games as separate  doors  before  you 
  318. started  using  this program then it is best that you remove  all 
  319. the  batch files that were used to run them,  also  remove  there 
  320. names from the doors menus.
  321. If  you  do not do the above then the games will be able  to  run 
  322. from  BOTH the monitor AND by a door.  BUT the score  the  player 
  323. receives  by not going to the monitor will be lost in there total 
  324. score kept on the monitor.
  325. If  your  players use the monitor then when they end  there  game 
  326. they  will return to the monitor.  If you allow the uses to  call 
  327. the games from the door then they will be returned to the RBBS.
  328.  
  329. The  last  entry of the GAMES.BAT file must NOT  call  your  RBBS 
  330. batch file.  If it does your system WILL run out of memory.  This 
  331. is new with this version of RBBS.
  332.  
  333. The following is for a NON-MULTI TASKING and MULTI TASKING. 
  334. -----------------------------------------------------------
  335.  
  336.  (The GAMES.BAT file )
  337.  
  338.   WATCHDG1  OFF                      To allow monitor program to 
  339.                                      monitor line (a must!!)
  340.   MONITOR %1                         Call the monitor monitor pgm.
  341.  
  342. DO NOT PUT RBBS.BAT at the end of this file
  343.  
  344. Do  NOT remove the 'WATCHDGx ON' call from the RBBS.BAT files  as 
  345. they  are needed when you go to your DOS from remote (7 from  the 
  346. main menu).
  347.  
  348. 2.3 Running the monitor 
  349. -----------------------
  350. After  completing  the  setup as stated above  insure  that  when 
  351. running the CONFIG file for the RBBS that you have the doors open 
  352. and  allow  the correct access level users to use the doors  that 
  353. you want.
  354.  
  355. That is all that is needed to make this work in remote.   To  run 
  356. the  program in local you must sign on the RBBS at your  keyboard 
  357. (remember  what node if you are multi tasking) and then when  the 
  358. Main menu is displayed sign off. Then break out of the batch loop 
  359. and enter MONITOR (If you are running NON-Multi Tasking), MONITOR 
  360. 1 (If you are on node 1), MONITOR 2 (If you are on node 2).  This 
  361. will  bring up the monitor game in local and you can run/play  in 
  362. the local mode which functions the same as remote.
  363.  
  364.  
  365. While  watching the screen when a remote user is on  the  monitor 
  366. you  will  see the users name is in the lower left corner of  the 
  367. screen,  in  the middle will be the version # of the  MONITOR.EXE 
  368. program that you are using and the node that is operating, and on 
  369. the  right  side  you will have displayed the  monitor  the  user 
  370. started  using the monitor game in a few minutes this  area  will 
  371. state  how many total minutes the user is allowed each day and  a 
  372. few seconds later the number of minutes/seconds he has left (this 
  373. will  update and stay on the screen until the monitor is  left.). 
  374. Also  when the remote users screen does a clear yours will NOT it 
  375. will  just print (CLEAR SCREEN).  The purpose of this is to  keep 
  376. the 25 line on your screen and clear to remote users screen.
  377.  
  378. The  following  two paragraphs are only true when using NO  multi 
  379. tasking or when using Double DOS.
  380.  
  381. Pressing  the  function  #10 key while a remote user  is  on  the 
  382. system will place you in the chat mode and allow you to talk with 
  383. the player.   To return the player to the game you must press the 
  384. ESC  key this is the same procedure as on the RBBS.   The  player 
  385. does NOT have a function on his menu to call you.
  386.  
  387. Pressing the function #8 key allows you to reduce or increase the 
  388. monitor  the  player  is  allowed to stay  on  monitor  this  one 
  389. monitor.   You  will  get a prompt for the number of minutes  you 
  390. wish  to let them have then you enter a number and  press  enter.  
  391. This will cause a message to be place on the screen to inform the 
  392. player that the amount of monitor has changed.
  393.  
  394. So you got a problem!!!
  395. -----------------------
  396. If you have a problem installing this program or it bombs on  you 
  397. look for the following data:
  398.  
  399. 1. A printout displayed on your screen telling you the problem.
  400. 2. Look  on  the disk that holds the main DOR program for a  file 
  401.    named  ERRORS.DOR and print it.  This info should be forwarded 
  402.    to me for debuging and correction.
  403.  
  404. In most cases (all I hope) one of the 2 above indications  should 
  405. happen  when a error occurs.  All errors should be reported to be 
  406. via phone or RBBS if possible for correction.
  407.  
  408. If  you wish to run your own doors using the game monitor here is 
  409. some infomation that may be of help:
  410.  
  411.  1. There are 2 temporary files that carry infomation between the 
  412.     monitor. TIMEOFFx.DOR and POINTSx.DOR.
  413.  2. The TIMEOFFx.DOR carries info from monitor to games.
  414.     >> x=the node this is operating on. <<
  415.     (A.) Format:
  416.          1st field  The sign off time in seconds past midnight.
  417.          2nd field  The  users  number in the  monitor  NAMES.DOR 
  418.                     file.
  419.          3rd field  The number of points the user has.
  420.          4th field  The number of minutes allowed in this session
  421.                     (if time is less the total allowed this date)
  422.          5th field  The number of nulls used.
  423.          6th field  1=graphics on 0=graphics off
  424.          7th field  The directory/sub-directory the monitor is on.
  425.          8th field  "Y" sound on "N" sound off
  426.  
  427.     It  is BEST just to read this information.  If you change  it 
  428.     you are on your own.
  429.  
  430.  3.  The  POINTSx.DOR  carries  information from the game to  the     
  431.      monitor.
  432.     (A.) Format:
  433.          1st field  The  time in seconds past midnight this  file 
  434.                     was made.   
  435.          2nd field  The score that was made in game.
  436.    
  437.     This file must be created by your software.
  438.  
  439. To  get  the  minutes  past midnight you may  use  the  following 
  440. basic statement.
  441. MIDSEC!=CSNG(FIX((VAL(MID$(TIME$,1,2))*60*60)+(VAL(MID$(TIME$,4,2)
  442. )*60)+(VAL(MID$(TIME$,7,2)))))
  443.  
  444. Good luck and enjoy this software.
  445.  
  446.                                  Bob...
  447.                                             
  448.